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600 

Class Hierarchy 

class java.long.Object 

interface com.ibm.jtcApplicationMediator (extends com.ibm.jtc.JTC) 

class com.ibm.jtcApplicationMediatorlmpI (implements com.ibm.jtc.ApplicationMediator, 

com.ibm.jtc.ViewListener, com.ibm.jtc.RequestResponseListener) 

interface com.ibm.jtc.Destination (extends com.ibm.jtc.JTC) 

class com.ibm.jtc.Destinationlrnpl (implements com.ibm.jtc.Destination) 

class java.util.EventObject (implements java.io.Serializable) 

class com.ibm.jtc.PlacementEvent (implements java.io.Serializable) 

class com.ibm.jtc.RequestEvent (implements java.io.Serializable) 

class com.ibm.jtc.TopEvent (implements java.io.Serializable) 

class com.ibm.jtc.ViewEvent (implements java.io.Serializable) 
class com. ibm.jtc. Factory (implements java.io.Serializable) 
interface com.ibm.jtc.JTC (extends java.io.Serializable) 
interface com.ibm.jtc.PlacementListener 
interface com. ibm.jtc. RequestListener 
interface com. ibm.jtc. RequestResponseListener 
class java.lang.Throwable (implements java.io.Serializable) 

class java.lang. Exception 

class com. ibm.jtc. RequestException (implements java.io.Serializable) 
class com.ibm.jtc.ValidationRuleException (implements java.io.Serializable) 
interface com.ibm.jtc.TopListener 

class com.ibm.jtc.Transporter (implements com.ibm.jtc. RequestListener, com.ibm.jtc.JTC) 
class com.ibm.jtc.ValidationRule (implements java.io.Serializable) 
interface com.ibm.jtc.ViewController (extends com.ibm.jtc.JTC) 
interface com.ibm.jtc.ViewListener 
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ValidationRule fJQ 1 2A 
Voriobles * / 



Nome 


Declaration 


Descriotion 


_copyright 


public static final String_copyright 


(c) International Business Machines Inc., 
1997 1998 1999. All rights reserved. 


NONE 


public static final int NONE 




COMPONENT 


public static final int COMPONENT 




FOCUS 


public static final int FOCUS 




VIEWEVENT 


public static final int VIEWEVENT 





„ , , FIG. 12B ,2 , 02 

Constructors / 



Name 


Declaration 


Description 


ValidationRule 


public ValidationRuleQ 





„ T „ ^ n ^ 1206 

FIG. 1 2D / 
/** ' 

* Given a list of class names, apply each validation rule of the classes 

* to input string and return the formatted result. 
* 

* ©return the viewable formatted string. 

* ©param classNames a comma-separated fully qualified list of concrete AbstractRule classes. 

* ©param input the input string to apply edit rules to. 

* ©exception ValidatonRuleException if there was an error in applying the edits. 

•/ 

public static String applyEdits(String classNames, String input) throws ValidationRuleException j 
int commalndex = -1; 
int curlndex = 0; 
do \ 

commaIndex=classNames.indexOf(\ , I curlndex); 
if (commalndex == -1) { 

commalndex = classNames.length(); 

String className = classNames. substring(curlndex, commalndex). trim(); 
try | 

ValidationRule rule = (ValidationRule) Factory.newlnstance(className); 

input = rule.edit(input); 
| catch (ValidationRuleException re) | 

throw re; 
j catch (Exception e) { 

throw new ValidationRuleException('*Rule class "' + className + not found."); 

• i • 

curlndex = commalndex + 1; 
| while (curlndex < classNames.lengthQ); 
return input; 
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1706 

ApplicotionMediotor ImpI.exitQ : AUS8- 1999 -0694 
/•• 

* Exit the ApplicotionMediotor by exiting oil allocated ViewControllers 

* and ApplicationMediotors. All data is set to null, and lists are 

* destroyed. An 'exited' ApplicotionMediotor cannot be used again. 

* If this method is overriden in a subclass, be sure to invoke 

* super.exitQ; 

**/ 

public void exit() { 

synchronized (this) \ 

/* Used for style 1 event dispatching. Leave this code commented. */ 
//if (this.eventthread !=null) \ 
II try { 

// eventThread.stop (); 

// j catch (Exception e) j 

/* Used for style 2 event dispatching. Leave this code commented. */ 
for (int i = 0; i < runningThreods.sizeQ; i++) j 

((ApplicationMediatorThread) runningThreads.elementAt (i)) .stopQ; 

runningThreads.removeAIIEIements(); 
viewListeners.removeAIIEIements(); 
try j 

for (int i = 0; i < viewControllers.size(); { 

((ViewControllers viewControllers.elementAt(i)) .setEnabled(false); 
((ViewController) viewControllers.elementAt(i)) .exit (); 

for (int i = 0; i < applicationMediators.sizeQ; i++) \ 

((ApplicotionMediotor) opplicationMediators.elementAt(i)) .setEnabled(false); 
((ApplicotionMediotor) applicQtionMediotors.elementAt(i)) ,exit(); 

| catch (Exception noProblem) { 

viewControllers = null; 
opplicationMediators = null; 
runningThreads = null; 
runningThreads = null; 
data = null; 

FIG. 17F 
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1708 
/ 

ApplicotionMediotorlmDl.cleorQ : AUS8- 1999-0694 
/•• 

* Clear the ApplicationMediotor by clearing all allocated ViewControllers 

* and ApplicationMediators. All data is set to null, but lists are 

* not destroyed. A 'cleared* ApplicationMediotor can be used again. 

* If this methed is overriden in a subclass, be sure to invoke 

* super.clear(); 

*/ 

public void clear() j 

synchronized (this) | 

/* Used for style 1 event dispatching. Leave this code commented. */ 
//if (this.eventthread != null) j 
// try j 

// eventThread.stop (); 

// | catch (Exception e) j 

'/n 1 

/* Used for style 2 event dispatching. Leave this code commented. */ 
for (int i = 0; i < runningThreads.size(); i++) j 

((ApplicationMediatorThread) runningThreads.elementAt (i)) .stop(); 

runningThreads.removeAIIEIements(); 
try j 

for (int i = 0; i < viewControllers.sizeQ; j 

((ViewController) viewControllers.elementAt(i)) .setEnabled(false); 
((ViewController) viewControllers.elementAt(i)) .clear (); 

for (int i = 0; i < opplicationMediators.size(); i++) { 

^ApplicationMediotor) applicationMediators.elementAtfi)) .setEnabled(false); 
((ApplicationMediotor) applicationMediators.elementAt(i)) .clear(); 

| catch (Exception noRealProblem) j 

viewControllers = null; 
applicationMediators = null; 
data = null; 

viewListeners.removeAIIEIements(); 

FIG. 17G 
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1710 

* Initolize the ApplicationMediotor using the listeners of an 

* existing ApplicationMediotor. 

*/ 

public void init(ApplicationMediator applicationMediator) { 

if (applicationMediator instanceof ApplicationMediotorlmpI) { 

ApplicationMediatorlmpI a = (ApplicationMediotorlmpI) applicationMediator; 
requestListeners = (Vector) a.requestl_isteners.clone(); 
placementListeners = (Vector) a.placementListeners.clone(); 
topListeners = (Vector) a.topListeners.clone(); 
addViewListener(a); 



initQ; 



FIG. 1 7H 



1712 

* When new data arrives allow the ViewControllers 

* and ApplicationControllers to be refreshed also. 

*/ 

public void refresh(Object data) \ 
this.data = data; 
try { 

synchronized (viewControllers) | 

for (int j = 0; j < viewControllers.size(); j++) { 

((ViewController) viewControllers.elementAt(j)). 
refresh(data); 

| catch (Exception noRealProblem) j 
try \ 

synchronized (applicationMediators) { 

for (int j = 0; j < applicationMediators.size(); { 
((ApplicationMediator) applicationMediators. 
elementAt(j)).refresh(data); 

\ catch (Exception noRealProblem) j 



FIG. 1 71 
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1714 

/ 

* A ViewEvent is delivered. Process it using Threading style 1 or 2. In 

* the end, the processViewEvent will be colled on the subclass. 

v 

public void viewEventPerformed (ViewEvent e) | 

/* Used for style 2 event dispatching, start an inner class thread *> 
ApplicationMediatorThread t = new ApplicationMediatorThread (e); 
runningThreads.addElement (t); 
t.start (); 

/* Used for style 1 event dispatching. Leave this code commented. 

//ViewEvent saved = saveViewEvent(e); 

//if (eventThread == null | | !eventThread.isAlive()) \ 

// finished = false; 

// eventThread = new Thread(this); 

// eventThreod.stort (); 

/i\ 

//synchronized (this) { 
// notify(); 

1 FIG. 1 7 J 



1714 

< 

* This method is used in style 1 threading. Rename this to run () 

* and uncomment the code as described in the class javadoc. 
*/ 

public final void run2 .() | 

/* Used for style 1 event dispatching. Leave this code commented. */ 

/* 

while (true) { 

ViewEvent event = null; 
event = getViewEvent (); 
if (event != null) | 

handleViewEvent (event); 
| else j 

waitForEvent (); 

if (finished) { 

// something went wrong with the thread so hose this loop 
break; 

I 



FIG. 1 7K 
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1714 

/ 

/" 

* Private class to handle executions of ViewEvents () on another thread. 

"/ 

private class ApplicationMediatorThread extends Thread j 

/» 

* The current event 

*•/ 

private ViewEvent event; 

A* 

* Create an ApplicationMediatorThread to process the ViewEvent 

**/ 

public ApplicationMediatorThread(ViewEvent event) j 
super (); 

this.event = event; 

* Just call the handleViewEvent method that the subclass will override 

••/ 

public void run () j 

processViewEvent (event); 



FIG. 1 7L 
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/ 

/«• 

* Save the current ViewEvent on a Q 

v 

private final ViewEvent saveViewEvent (ViewEvent e) { 

/* Used for style 1 event dispatching. Leave this code commented. */ 
//return viewEventQueue.add(e); 
return null; 

i 

/** 

* Method: return the first view event saved. Used by the Q'ing system. 

*/ 

private ViewEvent getViewEvent () { 

/* Used for style 1 event dispatching. Leave this code commented. */ 
//return (ViewEvent) viewEventQueue.remove(); 
return null; 

! FIG. 1 7M 
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Tronsporter.reQuestEventPerformed(RequestEvent) :AUS8- 1 999-0693 
/** 

* Submit a synchronous request. For each Destination that is listening for 

* the current family of RequestEvents (the major code), send the RequestEvent 

* to the Destination for processing. If there is a problem, throw 

* a RequestException. Continue processing the RequestEvent as long 

* as a RequestException is not thrown by a Destination and the RequestEvent 

* is not consumed. 

* <p> 

* If tagging is enabled, then append a status tag to the RequestEvent. 
*<p> 

* Destinations are processed in the following FIFO order: 

* 1- All using "!" (priority). 

* 2- All using a major code. 

* 3- All using "*". 
*<p> 

* ©exception RequestException if the Request can't be submitted 

v 

public void requestEventPerformed(RequestEvent request) throws RequestException { 
if (lenabled) \ 

throw new RequestException("Transporter disabled"); 

/* Try to tag the request */ X 
if (tagging) v 2606 
request.setStatus(request.getStatus() + "[Transporter]"); 

/* Process PRIORITY, major and then WILDCARD destinations */ 
processDestinations(request, getDestinationsf PRIORITY)); 
processDestinations(request, getDestinations(request.getMajorQ)); 
processDestinations(request, getDestinations(WILDCARD)); 



FIG. 26F 



I 



** 



* Submit an asynchronous request. See the synchronous 

* requestEventPerformed for more information. 

v 

public void requestEventPerformed(RequestEvent request, 
RequestResponseListener caller) throws RequestException { 
if (lenabled) \ 

throw new RequestException("Transporter disabled"); 

if (tagging) 

request.setStatus(request.getStatus() + 

"[Transporter async.]"); "^2608 

//start an inner class thread 

TransporterThread t = new TransporterThread(request, caller); 

runninqThreads.put(request, t); 

t.startQ; 

' FIG. 26G 
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2610 

Tronsporter.TronsporterThreod :AUS8- 1 999-0693 

A* 

* Private class to handle executions of submits() on another 
threod. 

private class TransporterThread extends Thread \ 

/•• 

* The current request 

/•• 

private RequestEvent request; 

A* 

* The caller of submit that we will call back 

«/ 

private RequestResponseListener caller; 



A* 

* Create a transporter thread 

••/ 

public TransporterThread(RequestEvent request, 
RequestResponseListener caller) j 
super(); 

this.request = request; 
this. caller = caller; 

i 

A* 

* Just call the synchronous version of 
requestEventPerformedQ 

**/ 

public void run() j 
try | 

requestEventPerformed(request); 

caller.requestResponse(request); 
\ catch (RequestException yikes); j 

caller.requestException(yikes); 
\ finally \ 

runningThreads.remove(request); 



FIG. 26H 
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RemoteDestinotion.requestEventPerformed(RequestEvent) :AUS8- 1 999-0704 

A* 

* Process request event. 

* <P>PRE: None 

* <P>P0ST: None 



* ©poram request the RequestEvent object to be processed. 

* ©exception RequestException if there was an error during the 

* processing of the event. 
*/ 

public void requestEventPerformed(RequestEvent request) throws 
RequestException j 
try | 

Method method = null; 
if (session == null) \ 

// get home interface. 
Context ctxt = getlnitialContext(); 
Object home = ctxt.lookup(request.getMojor() + 



"SessionHome"); 



i 



method = home.getClass().getMethod( << creote M ( null); 
session = method.invoke(home, null); 



//get method on home object and invoke it. 

method = session. qetClass().getMethod(request.getMinor() ( 

new Class[] JObject.classj); 
request.setData(method.invoke(session, new Object[] 
Jrequest.getData()D); 

if (request.getMinor().equals("remove ,, )) j 
session = null; 

| catch (InvocationTargetException te) j 

throw new RequestException(te.getTargetException()); 
| catch (Throwable t) j 

throw new RequestException(t); 



i 



FIG. 28D 



\ 

2806 



Variables 



Factory 



Name 


Declaration 


Description 


.copyright 


public static final String_copyright 


(c) International Business Machines Inc., 
1997 1998 1999. All rights reserved. 



FIG. 29A 
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View Controller 
C START ) 



Select screen 



Create class 



Override init() method 
replace with code to 
create, initialize and 
layout graphical 
components 



Override 
refreshQ method 



Override 
clearQ method 



Add view controller 
as components 

event listener 



Implement 
event listeners 



Use validation 
rules to validate 
user input 



Create and fire 
ViewEvents 



( END ) 

FIG. 31 



Creote Validation Rule 
( START 



Choose business 
validation rule 



Create class 



Override editQ 
method 



Override 
normalizeQ method 



3200 



3202 



-3204 



3206 




Validation 

rule 
exception 



( END ) 

FIG. 32 



Create a ViewEvent 
( START ) 



3210 



Creote interface to 
ViewEvent codes 
in application 



I 



3300 



Create instance 
of ViewEvent 



Send ViewEvent 



3302 



■3304 



C END ) 

FIG. 33 
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3400- 
3402- 
3404- 
3406- 

3408- 

3410- 
3412- 



Create 
ApplicotionMediotor 

( START ) 



Choose function 



Create class 



Override init() method 



Create ViewControllers 



Override process 
ViewEventQ method 



Create RequestEvents 



Involve refresh 



( END ) 

FIG. 34 



Create RequestEvent 
( START ) 



Create interface 
to contain strings 
of major and minor 
codes of RequestEvents 



Create instance 
of RequestEvent 



Send event using fire 
RequestEventQ method 



C END ) 

FIG. 35 

Create a Destination 
( START ) 



Choose destination 



Create class 



Override init() method 



Override 
requestEventPerformed() 
method 



Override 
cancelQ method 



Override 
finalizeQ method 



( END ) 

FIG. 36 



■3500 



3502 



-3504 



■3600 
■3602 
•3604 

■3606 

■3608 
3610 
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Create TopListener 
( START ) 



3700- 



3702- 



3704 



3706- 



3708- 



Create class that 
contains or is in the top 

frame of application 
and implements interface 



Create exitQ method 



Create launchQ 
method 



Create message() 
method 



Create title() method 
( END ) 

FIG. 37 



Create 
PlacementListener 

C START ) 



Create type 
of placement 



Create class 
implementing 

PlacementListener 
interface 



Implement 
placement method 

C END ) 

FIG. 38 



■3800 



3802 



-3804 
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Basic Operation of a ViewControllerlmpI 



4000- 

4002- 
4004- 
4006- 

4008- 
4010- 



4012 



( START ) 



implement 
the ViewController 
Interface 



Implement 
the JTC Interface 



Add specific methods 



Create and 
compose the GUI 



Return "yourself" 
in getComponent 



Return permission 
keys, resources and 
properties when asked 



Update permission 
keys, resources and 
properties when asked 



FIG. 40 









Handle internal 
AWT events 


"^-4014 








Validate and 
format data fields 


^-4016 


ir 






Issue ViewEvents for 
semantic interpretation 


^-4018 








Return the AWT 
thread immediately 


^4020 


IF 






Handle refresh calls 
to update the GUI 


"-4022 


V 






Access the data 


"^4024 




( END ) 
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4100- 



4104 

4106 
4108 

4110- 



4114- 

4116- 

4118- 
4120- 



( START ) 



ApplicotionMediotor 
receives ViewEvent 
from ViewController 




Creote PlocementEvent 
with proper majorCode 



Fire PlocementEvent 



Invoke PlacementListener 



PlacementListener 
receives 
PlocementEvent 




majorCode = = 
PlacementHTML 

4112 " Iyes 



Call toHTML() on 
ViewController component 



Translate View 
components into 
HTML components 



Create and place 
OtherAlternateView 



-4124 



Generate HTML output 



Send HTML output to 
client Browser for display 



( END ) 



FIG. 41 
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ViewEvent and ViewListener Usage 

—►Usage from a ViewController 

public void actionPerformed(ActionEvent e) \ 
if (e.getSource() == nextButton) { 

ViewEvent ve = new ViewEvent (this); 
ve.setMajor(ViewEvent.NEXT); 
fireViewEvent(ve); //notify 
ViewEvent listener 
return; 



FIG. 42 



—►Usage from ViewListener (i.e. ApplicationMediator) 
//add myself as a listener 
customerDetailsViewController.addViewListener(this); 

//later, we are called back on this method to handle the 
ViewEvent 

processViewEvent (ViewEvent event) j 
//do something 
switch (event.getMajor()) \ 

case ViewEvent. NEXT: //... 

break; 

case ViewEvent.OK: //.. 
break; 



FIG. 43 
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ValidationRules Usage 

Example Chaining 
//each rule 

String range = "com.xyz.jtc.RangeChecker"; 
String money = "com.xyz.jtc.AccountMoney'; 

//build the chain of rules 
String[] rules = jrange, moneyj; 

//get the value to validate 
String value = textField.getText(); 

try j 

value = applyEdits(rules, input); 
catch (ValidationRuleException ouch) { 

//- 

i 

//the value is validated and formatted, redisplay 
textField.setText(value); 

FIG. 47 

ViewControllerBaselmpI 

For example: 

♦ inheritance 

public class ViewControllerBaselmpI extends JPanel \ 
public Component getComponent() | 
return this; 

t 

FIG. 48 

♦ delegation 

public class ViewControllerBaselmpI implements ViewController 

^ XYZ xyz = new XYZ(); 

public java.awt.Component getComponent() \ 
return xyz; 

public void setEnabled(boolean e) { 
xyz.setEnabled(e); 

public void setVisible(boolean v) { 
xyz.setVisible(v); 

1 FIG. 49 
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C START ) 



5200- 
5202- 
5204- 

5206- 



5208- 



5210- 



5214 



5216- 



5218- 



5220- 



5222- 



Implement 
ApplicotionMediotor Interfoce 



Implement JTC Interfoce 



Add 

ApplicotionMediatorlmpI methods 



Create ViewControllers 
using initViewControllers 



3 



FIG. 52 

Design Steps for 
an ApplicotionMediotor 



Use InitApplicationMediator 
to create other 
ApplicationMediators 
os necessary 













Listen for ViewEvents 
ond RequestEvents 




ViewEvent^. NO 





\i received? 




5212^ 


YES 


Request PlacementListener 

to put another 
ViewController on screen 






Have TopListener do desktop 
operations as appropriate 




i r 


Fire appropriate 
requestEvents to servers 








Send refresh calls to 
ViewControllers and 
ApplicationMediators 






Return all JTC 
objects allocated 




i 
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5300 



c 



Placement runtime 



"click" 

J C 

AWTEvent 



"I 



C 



ValidationRules 



0 1 >i>c>> l [>] 



ViewController V— ValidationRuleException 

— s 



5302 
5308 



ViewEvent ^ 



5304 



PlocementListener 



17 



5306 



ApplicotionMediator 



[<] | > t> t> E> j 



3 



PlacementEvent 



5310- 



> 



extends 



subclass 



> 



FIG. 53 



Placement example 

—►Usage from ApplicotionMediator 

//in an ApplicotionMediator 

int major = PlacementEvent.ADD; 

Component component = 

customerDetailsViewController.getComponentQ; 

PlacementEvent e = new PlacementEvent(this, component, major); 

firePlacementEvent(e); 

FIG. 54 



—►Usage from PlocementListener 

public class MyProgram implements PlocementListener | 

public void placementEventPerformed(PlacementEvent e) \ 
//decide based on source type 
switch (e.getMajor()) { 

case PlacementEvent.ADD: 

if (e.getSource() instanceof PreferencesAm) 
panel l.addf Center" , e.getComponent()); 

else panel2.addfA" ( e.getComponent()); 
break; 

case PlacementEvent. REMOVE: 
//do something else 

break; 



i 

//etc. 
I 



FIG. 55 
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( START ) 



5600- 



5602- 



5604- 



5606- 



ViewControllers respond 
to getComponentQ 



ApplicotionMediotors control 
ordering of ViewControllers 



ApplicotionMediotors 
fire PlocementEvents 



PlocementListeners select the 
proper implementation and place 
the Component on the screen 



( END ) 



FIG. 56 

Design Steps for 
a PlacementEvent 



5700 



•click" 



PlocementListener 



f<| | t> o o o | [&1 



TopListener runtime 



rs=n 



C 



ValidationRules 



<^ AWTEvent ^> 



ViewController 
1 



ValidationRuleException 



3 




o-v- a gft r<^6" gip g Qg ^"7^ ^TopEvent^ ^ 



^TopListener^ 




PlacementEvent 



extends 



V 
5702 



^ subclass^ 



lounch 



exit 



FIG. 57 



desktop 



browser 



reconfigure 
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Transporter 

This class implements the JTC and RequestEventListener interfaces 
Its primary function is to map RequestEvents to Destinations. 
♦ Typically ApplicationMediators fire RequestEvents and Destinations process 
them 

Add a Transporter to an ApplicationMediator to listen for RequestEvents 



Transporter t = new Transported); 
ApplicationMediator am = new ApplicationMediatorQ; . 
am.addRequestListener(t); 

The ApplicationMediator will fire RequestEvents 

RequestEvent r = new RequestEvent(source, major, minor, data); 
try | 

fireRequestEvent(r); 
catch (RequestException yikes) jj 

FIG. 67 
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Destination 

RequestEvents are identified by 

♦ major code - represents a family of Requests 

♦ minor code - represents a specific Request 

Destinations are added to the Transporter as DestinationListeners 

specifing a major code for RequestEvents they are interested in receiving 
The destination is called when the major code of the RequestEvent 
matches the destination major code 



EJBDestination d = new EJBDestinationQ; 
Transporter t = new Transported); 
String major = "Loans"; 
t.addDestination[_istener(major ( d); 



Multiple Destinations can listen for the same RequestEvent major code 

♦ processed FIFO/FESP (first in first out, first exception stop forwarding) 

♦ results of one Destination can be passed to the next Destination 

FIG. 69 



Destinations and major codes 

Special major codes 

♦ wildcard 

■ "*" major code indicates the Destination is interested in all and any RequestEvents 

■ processed after specific major codes have been matched. 

♦ priority 

■ "!" major code indicates the Destination is interested in all requests and should be given 
priority. 

■ processing performed before specific major codes and wildcards 
For example 

Transporter t = new Transported); 
t.addDestinationListener ("*", new WildDestination ()); 
t.addDestinationListener ("Loans", new EJBDestinationQ); 
t.addDestinationListener ("!", new PriorityDestinationQ); 

//later 

RequestEvent r = new RequestEvent(this, 'loans", " null); 
try | 

fireRequestEvent(r); 
catch (RequestException yikes) \\ 

♦The RequestEvent "r" will be sent to PriorityDestination 1st, EJBDestination 2nd, 
and WildDestinationQ 3rd, assuming no RequestExceptions are thrown. 

FIG. 70 
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( START ) 



Coll getJTCs 
and get Vector 
of JTC objects 



7500 




7506- 



YES 



Use entry(i) 



7508 



Listen 
for events 
and debug, 
log, trace, 
simulate 



7524 




( RETURN ) 



7520 

instanceof 
.Transporter'* 




Add as 
RequestListner 



hookAWts with 
Component 

1 



7522 



Add as 
RequestListener 



hookAWts with 
Component 



7518 



7510 



7512 
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A31 






/ 

7610 




S 

7612 



■7606 



A32 



7614 



FIG. 76 



hookAWTs with 
Component XYZ 




7702 



7706- 



Get list of 
Components in 
Container XYZ 




Use 
Component(i) 



Hook 
the Component 

XYZ 



-7714 



77 08^Cp 



( RETURN ) 



Hook 
the Component(i) 

I 



7710 
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Data Objects 

v/The ApplicationMediotorlmpI will forward the refresh (default) 

rfor each: ApplicationMediator -> refresh(dato) 
for each: ViewController -> refresh(data); 

FIG. 79 



The ViewController will update the GUI 

public void refresh(Object data) j 
//this example uses a keyValue pair data model 

if (data == null) return; 
else refresh((KeyValue) data); 

public void refresh (KeyValue data) \ 

nameField.setText(data.get( ,< CustomerName ,, )); 
idField.setText(data.get( ,, Customerld ,I )); 
repaint(); //if necessary 

L' FIG. 80 



Data Objects 

/How can we add a new data model (i.e. real objects)? 

public void refresh(Object data) j 
if (data == null) return; 
else if (data instanceof Vector) | 
refresh((Vector) data); 

else if (data instanceof KeyValue) j 
refresh((KeyValue) data); 

1 FIG. 81 



public void refresh(Vector data) j 
//I know what they are 
Customer c = (Customer) data.elementAt(O); 
ID id = (ID) data.elementAt(l); 
nameField.setText(c.getName()); 
idField.setText(id.toString()); 
repaintQ; //if necessary 

1 FIG. 82 
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More on data 




c 



8300 



ViewController 



1. Named methods 

public double get CustomerName() 
Implicit data model and ViewEvent 
ve.setDataO'Mr. Chips 11 ); 
fireViewEvent(ve); 

Explicit data model and ViewEvent 
data.put("LASTNAME'\ "Chips"); 
ve.setData(data); 
fireViewEvent(ve); 
Property Change events 
data.put("SOLUTION", ,, JTC M ); 



async streaming 



FIG. 83 
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8410- 



C START ) 



ApplicotionMediotor receives 
ViewEvent from ViewController 




Create TopEvent with 
proper majorCode 



Fire TopEvent 



Invoke Set of TopListeners 



TopListener receives TopEvent 




8414 



Exit 

the application 



8418 

/ 



Display message 
for application 



, 8422 

Display title 
for application 



, 8426 

1 / 

Execute other 
application 



FIG. 84 
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8500- 
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8506- 
8508- 

8510- 



( START ) 



ApplicationMediotor 
receives ViewEvent 
from ViewController 



Create 
PlacementEvent with 
proper major code. 



i 



Fire PlacementEvent 



Invoke 
PlacementListener 



PlacementListener 
receives PlacementEvent 





8514 



Add ViewController's 
component to a visual 
container and repaint. 



8518 



Remove ViewController's 
component from a visual 
container and repaint. 



C END ) 

FIG. 85 
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Handling AWTEvents 



( START ) 



8600- 



8602- 



AWTEvent arrives 



Handle AWTEvent by 

manipulating GUI 
according to GUI spec 



8606- 
8608- 
8610- 




Create ViewEvent 



Disable ViewController 



fireViewEvent 



( RETURN ) 



FIG. 86 
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Apply ValidationRules 




8632 



Error message 



( RETURN ) 



I 
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Applying ValidationRules 
( START ) 



8708- 



Select Unopplied 
Validation rule for 
the Component 



Apply 
ValidationRule(i) to 
Component's value 




Success? 
8706 I NO 



Throw Exception 



( RETURN ) 

FIG. 87 



fireViewEvent 
( START ) 



-8700 




Select unprocessed 
ViewListener 




C RETURN ) 

FIG. 88 



Application Manager 
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C START ) 



Create 
ViewControllers 



Respond 
to Events 



( END ) 

FIG. 89 



Application Manager 
( START ) 



Data Event 



For Each 
ViewController Call 
Refresh (Data) 



( END ) 

FIG. 90 
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Application Manager 



9100- 



9102 



9104 



( START ) 



Add Listener 



Find 
Listener Type 



Add Listener 
Type to Vector 



C END ) 

FIG. 91 



Application Manager 
( START ) 



Remove Listener 



Find 
Listener Type 



Remove Listener 
From Vector 



C END ) 

FIG. 92 
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Application Manager 



C START ) 



9300 



<0- 

9302- 



Get/Set 
Permission 



Process 
Permission 



C END ) 

FIG. 93 
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Application Manager 
( START ) 



ViewEvent 



Process ViewEvent 



9400 



-9402 




Default 



Handle the Specific 
Request (Data) 



9410 



( END ) 

FIG. 94 
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9600- 
9602- 

9604- 

9606^. 



9610- 



9612 



refresh(Object data) 
in ApplicationMediator 

( START ) 



Refresh Object data 



Access data 



For each 
ApplicationMediator(i) 



ApplicationMediator(iVrefresh 
(Object data) 




For each 
ViewController(i) 



ViewController(i).refresh 
(Object data) 




C RETURN ) 

FIG. 96 



( START ) 



fireRequestEvent 



-9800 



Select 
RequestListener 



-9802 




RequestListener(i).requestEventPerformed 




( RETURN J 

FIG. 98 
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refresh(Object data) 
in ViewController 



( START ) 



Refresh (Object data) 



■9700 
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Use object(i) 
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Call refresh for 
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as in 




refresh (T data) 



Update 
locale state 



Update GUI 
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( START ) 



9900- 

9902- 
9904- 
9906- 
9908- 

9910- 
9912- 

9914- 
9916- 

9918- 



9936- 



9938- 



Create Top 
ApplicationMediator 



Add TopListeners 



Add RequestListeners 



Add PlacementListeners 



Add ViewListeners 



Create 2nd Level 
ApplicationMediator 



Clone TopListeners 



Clone RequestListeners 



Clone PlacementListeners 



Add Top 
ApplicationMediator 
as the ViewListener 




Create ViewController 



Add parent Level 
ApplicationMediator 
os the ViewListener 



FIG. 99 



9922 

Additional 
2nd Level 
ApplicationMediator 




Create 3rd Level 
ApplicationMediator 



Clone TopListeners 



Clone RequestListeners 



Clone PlacementListeners 



Add Upper Level 
ApplicationMediator 
as the ViewListener 



( END ) 
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C START ) 



10000- 



10002- 



10004- 



Receive user 
action input 



Create and fire 
component event 



ViewController receives 
component event 
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Is \ NO 
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ViewController creates 
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ApplicationMediator 
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Refire ViewEvent 
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receives ViewEvent 
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( START ) 



Load confiq file of 
ApplicationMediator 
state stanzas 



Build a multi- 
dimensional List of 
the config file 



Process events 
and calls 



( RETURN ) 
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Encoding ApplicationMediators 

—►SI: (VE.source==vc1 && VE.major==A && VE.minor==B) => 
(RE.mojor=C RE.minor=D RE.data=VE.data RE.fireS) 

if event source is vc1 with A,B as major/minor then 

fire sync request with C,D major/minor and use data from event) 

— »-S2: VE.source==vc4 && VE.major=-5) = = > (TE.major=3 TE.fire) 
if event source is vc4 with 5 as major then 
fire top event with major 3 

—►S3: (Refresh) = = > (VC.i.refresh(Refresh.data)) 

if refresh(data) occurs, then refresh all view controllers with the 
same data, but not the other application mediators 

-►S4: (VE.source==vcA) = = > (RE.major="set"RE.fireA) && 

(PE.major=PE.ADD PE.source=vcB PE.fire) && (VC.vcB.refresh(RE.data)) 
if event source is vcA, then fire async request, then fire placement 
event, then refresh the newly placed view controller with the data 
returned with the request 

FIG. 1 02 
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BaseSerializer 
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SerializerIF 

— 
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Deserialize 
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readObjectQ 
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BaseSerializer 
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SerializerIF 



Externalizable 
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Access State machine to see if processing is needed 



10300- 
10302- 



( START ) 



ViewEvent 



Get ViewEvent.source 



10304 



10308- 




Locote table entries matching 
source/ViewEvent. major/ 
ViewEvent. minor tuple 



10310 




Locate table entries 
matching source/ 
ViewEvent. major pair 



( RETURN ) 



Use table entry(i) 



10318 



•10312 



Does table 
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ViewEvent. major and/or 
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.ViewEvent. minor 
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NO 



More 

action entries NO 
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10316 
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10700 

package com.ibm.jtcx.serialization; 

import java.io.Externalizable; 

import jova.io.IOException; 

import java.io.Objectlnput; 

import java.io.ObjectOutput; 

A* 

* Default type comment. 
* 

* <P>INVARIANT: 
V 

public class BaseData implements Externalizable $ 
private Object[] data = null; 

A* 

* BaseData constructor comment. 

v 

public BaseDato() { 
this(O); 

* BaseData constructor comment. 

* @param dataArray java.lang.Object[] 

•/ 

public BaseData(int count) \ 
super(); 

setData(new Object[count]); 

A* 

* Default method comment. 
* 

* <P>PRE: 

* <P>P0ST: 

* 

* ©return Parameter not modified 

* ©return java.lang.Object[] 

•/ 

public final Objectf], getData() { 
return data; 

t 

FIG. 107 A 
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10700 

A* 

* Default method comment. 
* 

* <P>PRE: 

* <P>P0ST: 

* ©return Parameter not modified 

* ©return java.lang. Object 

* @param index int 

•/ 

public final Object getData(int index) { 
Object retVal = null; 

if ((data != null) && (index < data.length)) { 
retVal = data[index]; 

return retVal; 

* Default method comment. 
* 

* <P>PRE: 

* <P>POST: 

* 

* ©return Parameter not modified 

* ©param in Objectlnput 

•/ 

public void readExternal(Objectlnput in) 

throws ClassNotFoundException, lOException { 

setData((Object[])in.readObject()); 

A* 

* Default method comment. 

* <P>PRE: 

* <P>POST: 

* ©return Parameter not modified 

* ©param dataArroy java.lang.Object[] 

*/ 

public final void setDato(0bject[] dataArroy) \ 
data = dataArroy; 



FIG. 107B 
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10700 



/** 

* Default method comment. 
* 

* <P>PRE: 

* <P>P0ST: 

* ©return Parameter not modified 

* ©pararn index int 

* @param dataElement java.lang.Object 
*/ 

public final void setDota(int index, object dataElement) \ 
if ((data != null) && (index < data.length)) | 
data[index] = dataElement; 



/** 

* Default method comment. 
* 

* <P>PRE: 

* <P>P0ST: 

* 

* ©return Parameter not modified 

* ©param out ObjectOutput 
*/ 

public void writeExternal(ObjectOutput out) throws lOException 
out.writeObject(getData()); 



FIG. 107C 
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10800 



packoge com.ibm.jtcx.serialization; 

java.io.Externalizable; 
java.io.lOException; 
java.io.Objectlnput; 
java.io.ObjectOutput; 
java.moth.BigDecimol; 
javo.moth.Biglnteger; 



java.ut 
java.ut 
java.ut 
java.ut 
java.ut 
java.ut 
java.ut 



I.Date; 
(.Enumeration; 
I.GregorianCalendar; 
I.Hashtable; 
I.SimpleTimeZone; 
IJimeZone; 
I.Vector; 



import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
/** 

* Base class of data objects that require small serialization. The 

* attributes of the data object are stored in an array and the elements 

* of the array are written individually. 
* 

* <P> INVARIANT: 
V 

public class BaseDataS extends BaseData implements Externalizable \ 

/** 

* Default constructor. 

v 

public BaseDataS() { 
super(); 

* Creates a new <code>BaseDataS</code> object with a data array of 

* size <code>count</code>. 
. * 

: * @param count the size of the data array containing the attributes 

*/ 

public BcseDataS(int count) \ 
super(count); 

FIG. 1 08A 
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* Reads the array of data elements from the stream. The responsibility 

* of reading the individual element is left to the 

* <code>BaseSerializer</code> via <code>readObject()<code>. 
* 

* ©param in the input stream that contains the serialized object 

* ©exception ClassNotFoundException thrown if 

* <code>BaseSeriolizer</code>. fails to read the object from the stream 

* ©exception lOException thrown if 

* <code>BaseSerializer</code> fails to read the object from the stream 

* ©see BaseSerializer#readObject 

•/ 

public void readExternal(Objectlnput in) 

throws ClassNotFoundException, lOException j 

int size = in.reodShort(); 

if (size == -1) | 

setData(null); 

j else | 

Object[] array = new Object[size]; 

for (int i = 0; i < size; i++) j 

array[i] = BaseSerializer.getlnstanceQ.readObject(in); 



i 



setData(array); 



* Writes the array of data elements. The responsibility of writing the 

* data elements is left to <code>BaseSerializer</code> via 

* <code>writeObject()</code>. 
* 

* ©param out the output stream to which the data elements will be 

* written 

•/ 

public void writeExternal(ObjectOutput out) throws lOException | 
Object[] array = getData(); 

if (array = = ■ null) { 

out.writeShort(-l); 

| else | 

out.writeShort(array.length); 

for (int i = 0; i < orray.length; j 

BaseSerializer.getlnstance().writeObject(out, array[i]); 

S 1 v 

10800 

FIG. 1 08B 
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10900 



package com.ibm.jtcx.serialization; 

import java.io.IOException; 
import java.io.Objectlnput; 
import java.io.ObjectOutput; 

/** 

* The interface for those classes that serialize objects to and from 

* a stream. The object that implements this interface should write 

* just the object's attributes, not any other descriptive information 

* about the object. Typically, a <code>SerializerlF</code> knows how 

* to serialize a specific class. 

*/ 

public interface SerializerIF { 
A* 

* Reads an object from the stream. 
* 

* ©return The object that was read. 

* ©param in the input stream containing the object 

* ©exception java.io.IOException thrown if the stream fails 

* ©exception java.lang.ClassNotFoundException thrown if the stream 

* fails 

*/ 

Object read0bject(0bjectlnput in) throws lOException, ClassNotFoundException 
A* 

* Writes the given object to the stream. 
* 

* ©param out the output stream into which the object will be written 

* ©param element the object that will be written to the stream 

* ©exception java.io.IOException thrown if the stream fails 

•/ 

void writeObject(ObjectOutput out, Object element) throws lOException; 

FIG. 1 09 
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package com.ibm.jtcx.serialization; 

import 
import 
import 



import 
import 
import 
import 
import 
import 
import 



/ 



ova. io.*; 

ava.math.Biglnteger; 
ova. math. BigDecirnal; 



ava.ut 
ava.ut 
ava.ul 
ava.ut 
ava.ut 
ava.ut 
ava.ut 



Date; 

I.GregorianCalendar; 

I.Hashtable; 

LSimpleTimeZone; 

LStringTokenizer; 

[JimeZone; 

I.Vector; 



The <code>SerializerlF</code> that is used as the base level 
serializer. It contains three tables used to serialize objects: 
<br><ul> 

<li> codeTable: the table containing the serialization code of 

an object based on the name of the class 
<li> nameTable: the table containing the name of the class 

based on the serialization code 
<li> serializationTable: the table containing the serializer of 
an object based on its serialization code 

</ul> 
<br><br> 

<code>BaseSerializer</code> delegates the responsibility of 
serializing the objects to the <code>SerializerIF</code> associated 
with that class or to the object itself if it implements 
<code>Externalizable</code>. 

public class BaseSerializer implements SerializerIF \ 
static private final int NULL-OBJECT = 0; 
static private final int OTHER = OxOOff; 

static private final String HASHTABLE_SER = "ClassNameHash.ser"; 
static private final String INLFILE = "ClassNames.ini"; 

static private Hashtable codeTable = null; 

"static private Hashtable nameTable = null; 

static private Hashtable serializerTable = null; 

static private BaseSerializer instance = null; 

class BigDecimalSerializer implements Serializer IF j 

public Object readObject(Objectlnput in) throws ClassNotFoundException, lOException J 
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int scale = in.reodShortQ; 
int size = in.readShort(); 
byte[] bytes = new byte[size]; 
in.readFully(bytes); 

Biglnteger temp = new Biglnteger(bytes); 
return new BigDecimal(temp t scale); 

public void writeObject(ObjectOutput out, Object element) throws lOException { 
BigDecimal bigD = (BigDecimol)element; 

int scale = biqD.scale(); 
bigD.setScale(O); 



class BiglntegerSerializer implements SerializerIF \ 

public Object readObject(Objectlnput in) throws ClassNotFoundException, lOException 

int size = in.readShort(); 
byte[] bytes = new byte[size]; 
in.readFully(bytes); 

return new Biglnteger(bytes); 

public void writeObject(ObjectOutput out, Object element) throws lOException { 
byte[] bytes = ((Biglnteger)element).toByteArray(); 

out.writeShort(bytes.length); 
out.write(bytes); 

class BooleanSerializer implements SerializerIF { 

/ public Object read0bject(0bjectlnput in) throws ClassNotFoundException, .lOException 

int value = in.readByte(); 

return (value == 1) ? Boolean.TRUE: Boolean. FALSE; 

public void writeObject(ObjectOutput out, Object element) throws lOException j 
out.writeByte(((Boolean)element).booleonValue() ? 1 : 0); 




out.writeShort(scale); 

out.writeShort(bytes.length); 

out.write(bytes); 



FIG. 1 1 0B 
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class ByteSerializer implements SeriolizerIF { 

public Object read0bject(0bjectlnput in) throws ClassNotFoundException, lOException j 
byte value = in.readByte(); 

return new Byte(value); 

public void writeObject(ObjectOutput out, Object element) throws lOException { 
out.writeByte(((Byte)element).byteValue()); 

class CharacterSerializer implements SerializerIF { 

public Object read0bject(0bject Input in) throws ClassNotFoundException, lOException j 
char value = in.readChar(); 

return new Character(value); 

public void writeObject(ObjectOutput out, Object element) throws lOException \ 
out.writeChar(((Character)element).charVolue()); 

class DateSerializer implements SerializerIF | 

public Object read0bject(0bjectlnput in) throws ClassNotFoundException lOException { 
long value = in.readl_ong(); 

return new Dote(value); 

public void writeObject(ObjectOutput out, Object element) throws lOException { 
out.writeLong(((Date)element).getTimeQ); 

f 1 

class DoubleSerializer implements SerializerIF \ 

public Object read6bject(0bjectlnput in) throws ClassNotFoundException, lOException {. 
double value = in.readDouble(); 

return new Double(value); 

public void writeObject(ObjectOutput out, Object element) throws lOException J 
out.writeDouble(((Double)element).doubleValue()); 

1 FIG. 11 OC 
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closs FloatSeriolizer implements SeriolizerIF j 

public Object reod0bject(0bjectlnput in) throws ClassNotFoundException, lOException { 
float value = in.readFloat(); 

return new Float(value); 

public void write0bject(0bject0utput out, Object element) throws lOException | 
out.writeFloat(((Float)element).floatValue()); 

class GregorianCalendarSerializer implements SeriolizerIF | 

public Object reod0bject(0bjectlnput in) throws ClassNotFoundException, lOException { 
long time = in.readLongQ; 
Date date = new Date(time); 
SeriolizerIF seriolizer = BaseSerializer.getInstance(); 
TimeZone tz = (TimeZone)serializer.readObject(in); 

GregorianCalender gCalender = new GregorianCalendar(tz); 
gCalendar.setTime(date); 

return gCalendar; 

public void writeObject(ObjectOutput out, Object element) throws lOException \ 
GregorianCalendar temp = (GregorianCalendar)element; 

Date date = temp.getTime(); 
TimeZone tz = temp.getTimeZoneQ; 

out.writeLong(date.getTimeQ); 

SeriolizerIF seriolizer = BaseSeriolizer.getlnstance(); 

serializer.writeObject(out, tz); 

class IntegerSerializer implements SeriolizerIF | 

public Object read0bject(0bjectlnput in) throws ClassNotFoundException, lOException \ 
int value = in.readlntQ; 

return new Integer(value); 

public void write0bject(0bject0utput out, Object element) throws lOException { 
out.writeInt(((lnteger)element).intValue()); 

f ' 

class LongSerializer implements SeriolizerIF \ 

public Object read0bject(0bjectlnput in) throws ClassNotFoundException, lOException { 

fig. 11 on 
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long value = in.readLong(); 
return new Long(value); 

public void writeObject(ObjectOutput out, Object element) throws lOException j 
out.writeLong(((Long)element).longValue()); 

class ObjectArraySerializer implements SerializerIF j 

public Object readObject(Objectlnput in) throws ClassNotFoundException, lOException { 
int size = in.readShortQ; 

Object[] array = new Object[size]; 
for (int i = 0; i < size; i++) j 

SerializerIF serializer = BaseSerializer.getInstance(); 

arrayfi] = serializer.readObject(in); 

return array; 

public void writeObject(ObjectOutput out, Object element) throws lOException { 
Object[] array = (Object[])element; 

out.writeShort(array.length); 

for (int i = 0; i < array length, i++) } 

. SerializerIF serializer = BaseSerializer.getlnstance(); 
serializer.writeObject(out, array[i]; 

class ObjectSerializer implements SerializerIF j 

public Object read0bject(0bjectlnput in) throws ClassNotFoundException, lOException { 
return in.reodObject(); 

public void writeObject(ObjectOutput out, Object element) throws lOException \ 
out.writeObject(element); 

class ShortSerializer implements SerializerIF | 

public Object read0bject(0bjectlnput in) throws ClassNotFoundException, lOException j 
short value = in.readShort(); 

return new Short(value); 

FIG. 11 OE 
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public void writeObject(ObjectOutput out, Object element) throws IOException | 
out.writeShort(((Short)element).shortValue()); 



class SimpleTimeZoneSerializer implements SerializerIF \ 

public Object readObject(Objectlnput in) throws ClassNotFoundException, IOException { 
int offset = in.readlnt(); 

SerializerIF serializer = BaseSerializer.getlnstance(); 
String id = (String)serializer.reodObject(in); 

return new SimpleTimeZone(offset, id); 

public void writeObject(ObjectOutput out, Object element) throws IOException j 
SimpleTimeZone temp = (SimpleTimeZone)element; 

out.writeInt(temp.getRawOffset()); 

SerializerIF serializer = BaseSerializer.getInstance(); 

serializer.writeObject(out, temp.getlDQ); 

class StringSerializer implements SerializerIF | 

public Object read0bject(0bjectlnput in) throws ClassNotFoundException, IOException \ 
int size = in.readShort(); 
byte[] bytes = new byte[size]; 
in.readFully(bytes); 

return new String(bytes); 

public void writeObject(ObjectOutput out, Object element) throws IOException | 
byte[] bytes = ((String)element).getBytes(); 

out.writeShort(bytes.length); 
out.write(bytes); 



class VectorSerializer implements SerializerIF j 

public Object readObject(Objectlnput in) throws ClassNotFoundException, IOException { 
int size = in.readShortQ; 

Vector vector = new Vector(size); 
/; for (int i = 0; i < size; { 

SerializerIF serializer = BaseSerializer.getlnstance(); 
vector.addElement(seriolizer.readObject(in)); 

FIG. 11 OF 
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return vector; 

public void write0bject(0bject0utput out, Object element) throws lOException 
Vector temp = (Vector)element; 

Object[] array = new Object[temp.size()]; 
for (int i = 0; i < array.length; i++) \ 
arroy[i] = temp.elementAt(i); 

out.writeShort(array.length); 

for (int i = 0; i < array.length; i++) j 

SerializerIF serializer=BaseSerializer.getInstance(); 

serializer.writeObject(out, array[i]); 

/** 

* Default constructor. The constructor is private because this is a 

* singleton class. When the object is constructed, it initializes its 

* tables. 

•/ 

private BaseSerializer() { 
init(); 

A* 

* Adds the given elements to the three tables. 
* 

* ©param className the name of the class 

* ©param code the code for the given class 

* ©param serializer the object responsible for serializing the given 
, * class 

v 

private void addDataToTables(String className, Number code, SerializerIF serializer) \ 
getCodeTable().put(code, className); 
getNameToble().put(className, code); 

if (serializer != null) j 

getSerializerTable().put(code, serializer); 

FIG. 11 OG 
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* Creates the codes and seriolizer objects for the default serialization 

* classes and adds them to the tables. The tables are then written to 

* a serialized file. 

v 

private void createDefaultTables() { 

addDataToTables(BigDecimal. class. getName(), new Byte((byte)l), new 
BigDecimalSerializer()); 

addDataToTables(Biglnteger.class.getNameQ, new Byte((byte)2), new BiglntegerSerializer()); 

addDataToTablesfBoolean.class.getNameQ, new Bvte((byte)3), new BooleanSerializer()); 

addDataToTables(Byte.class.getName() l new Byte((byte)4), new ByteSerializer()); 

addDataToTables(Character.class.getName(), new Byte((byte)5), new CharacterSerializer()); 

addDataToTables(Date.class.getName(), new Byte((byte)6l new DateSerializerQ); 

addDataToTablesiDouble.class.getNameO, new Byte((byte)7), new DoubleSerializer()); 

addDataToTables(Float.class.getName(), new Byte((byte)8) ( new FloatSerializer()); ; 

addDataToTables(GreqorianCalendar.class.getName(), new Byte((byte)9), new 
GregorianCalendarSerializerQ; 

addDataToTablesflnteger.class.getName(), new Byte((byte)10), new lntegerSerializer()); 

addDataToTableslLong.class.getNameO, new Byte((byte)1 1), new LongSerializer()); 

addDataToTables(Short.class.getName() ( new Byte((byte)12), new ShortSerializerQ); 

addDataToTablesfSimpleTimeZone.class.getNameO, new Byte((byte)13), new 
SimpleTimeZoneSerializer()); 

addDataToTablesfString.class.getNameQ, new Byte((byte)14), new StringSerializer()); 

addDataToTables(Vector.class.getNameQ, new Byte((byte)15) f new VectorSerializerQ); 

addDataToTables(Object.class.getName(), new Byte((byte)16), new ObjectSerializer()); 

writeToblesQ; 

A* 

* Returns an instance of the table of class names, keyed by their code. 

* If the table does not exist, it is created. 
* 

* ©return The table of class names. 

V" 

protected Hashtable getCodeTable() | 
if (codeTable == null) \ 

codeTable = new Hashtable(); 

' FIG. 11 OH 
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return codeTable; 

i 

* Returns on instance of <code>BaseSeriaIizer</code>. 

* ©return An instance of <code>BaseSerializer</code>. 

•/ 

public static SerializerIF getlnstance() j 
if (instance == null) j 

instance = new BaseSerializer(); 

return instance; 

i 

A* 

* Returns an instance of the table of codes, keyed by their 

* corresponding class name. 

* If the table does not exist, it is created. 
* 

* ©return The table of codes. 

•/ 

protected Hashtable getNameTable() j 
if (nameTable == null) \ 

nameTable = new Hashtable(); 

i 

return nameTable; 

i 

/** 

* Returns an instance of the table of serializers, keyed by their 

* corresponding code. 

* If the table does not exist, it is created. 
♦ 

* @ return The table of class names. 

v 

protected Hashtable getSerializerTable() { 
if (serializerToble == null) j 

serializerTable = new Hashtable(); 

i 

return serializerTable; 

i 

A* 

* Initializes the hashtable from either a serialized hashtable or from 

* an ini file. 

FIG. 1 1 01 
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protected void init() { 

File seriolizedFile = new File(HASHTABLE_SER); 
File iniFile = new File(INLFILE); 

if (serializedFile.exists()) j 

readSeriolizedFile(seriolizedFile); 

| else | 

if (iniFile.exists()) | 

readlniFile(iniFile); 

i 

createDefaultTablesQ; 

* Gets the value of the serialization code from the table based on 

* the className provided. The value returned can either be a 

* <code>Byte</code> or an <code>Integer</code>. The return value 

* will be a <code>Byte</code> if the className is one of the base 

* data types. 
* 

* ©return The serialization code of the className. 

* ©param className the name of the class 

v t 

private Number lookupCode(String className) | 
Number code = null; 

if (className != null) { 

code = (Number)getNameTable().get(className); 

< : return code; 

i 

/** 

* Looks up the hashcode in the table and returns the String value of 

* the hashcode. If the hashcode does not exist in the table 

* <code>null</code> is returned. 
* 

* ©return The object that was stored in the table with the given 

* hashcode. 

* ©poram hashcode the hashcode that will be used to look up the value 

V FIG. 11 OJ 



109/119 
AUS990339US1 1 



11000 

private String lookupName(Number code) j 
String classNome = null; 

if (code != null) { 

classNome = (String)getCodeTable().get(code); 

return classNome; 

* Default method comment. 
* 

* <P>PRE: 

* <P>POST: 

* 

* ©return Parameter not modified 

* ©return com. ibnrujtc.util. SerializerIF 

* ©param code int 

*/ 

private SerializerIF lookupSerializer(Number code) j 
SerializerIF serializer = null; 

if (code != null) j 

serializer = (SerializerIF)getSerializerTable().get(code); 

return serializer; 

i 

A* 

* Default method comment. 

* <P>PRE: 

* <P>P0ST: 

* 

* ©return Parameter not modified 

* ©pa ram iniFile java.io.File 
*/ 

private void readlniFile(File iniFile) | 
BufferedReader in = null; 

try I 

in = new BufferedReader(new FileReader(iniFile)); 

for (String inLine = in.readLineQ; inLine != null; inLine = in.readLineQ) | 
String trimLine = inLine.trim(); 

FIG. 11 OK 
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if ((trimLine.length() > 0) && 

ItrimLine.startsWithO'jp')) { 

StringTokenizer tokenizer = new StringTokenizer(trimLine); 

String className = tokenizer.nextToken(); 

Integer code = new Integer(className.hashCode()); 

SeriolizerIF seriolizer = null; 

if (tokenizer.hasMoreTokens()) { 

String serializerName = tokenizer.nextToken(); 

try | 

seriolizer = (SerializerlF)Class.forName(serializerName).newlnstance(); 
\ cotch(Exception e) j | 

addDataToTables(className, code, seriolizer); 



writeTables(); 

/** 

* Reads the object from the stream by first reading the code for the 

* element then reads the appropriate data for that object. 



* ©return The object that was read from the stream. 

* ©param in the input stream that contains the object 

*A 

public Object readObject(Objectlnput in) 

throws ClassNotFoundException, lOException j 
Object retVal = null; 
Number code = null; 

byte baseCode = in.readByteQ; 




catch (Exception throwAway) { 



in.closeQ; 
catch (Exception throwAway) { 



FIG. 1 1 0L 
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if (boseCode == NULL_OBJECT) j 
retVal = null; 

\ else | 

if (boseCode != OTHER) | 

code = new Byte(baseCode); 

| else | 

int secondCode = in.reodInt(); 
code = new Integer(secondCode); 

SeriolizerIF serializer = lookupSerializer(code); 
if (serializer != null) j 

retVal = serializer. readObject(in); 

\ else | 

String className = lookupName(code); 
try \ 

retVal = Class.forNome(clossName).newlnstance(); 

if (retVal instanceof Externalizable) \ 

((Externalizable)retVal).readExternol(in); 

\ else { 

retVal = in.readObject(); 
| catch(Exception e) \ 



return retVal; 



* Reads the file containing the serialized hashtables of data. 
♦ 

* @param serializedFile the file containing the serialized tables 
*/ 

private void readSerializedFile(File serializedFile) { 
ObjectlnputStream in = null; 
try j 

in = new ObjectInputStream(new FilelnputStream(serializedFile)); 
codeTable = (Hashtable)in.readObjectQ; 
nameTable = (Hashtable)in.readObjectQ; 
serializerTable = (Hashtable)in.readObject(); 

FIG. 1 1 0M 
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catch (Exception throwAway) \ 
finally ] 
try | 

in.close(); 
\ catch (Exception throwAway) \ \ 

if ((codeTable == null) || 

(nameTable == null) || 
(serializerTable == null)) \ 



createDefaultTables(); 



** 



* Writes the given object to the stream. First, the code representing 

* the type of the object is written, then the data within the object 

* is written. 
* 

* ©param out the output stream that will contain the object 

* @param element the data object that will be written 

•/ 

public void write0bject(0bject0utput out, Object element) 
throws lOException j 

if (element == null) j 

out.writeByte(NULUOBJECT); 

| else | 

String className = element. getClass().getName(); 
Number code = lookupCode(className); 

if (code != null) { 

if (code instanceof Byte) { 

out.writeByte(code.byteValue()); 
| else if (code instanceof Integer) j 
out.writeByte(OTHER); 
out.writelnt(code.intValue()); 

SerializerIF serializer = lookupSerializer(code); 

if (serializer != null) j 

serializer.writeObject(out, element); 
\ else if (element instanceof Externalizable) j 

((Externalizable)element).writeExternal(out] 

FIG. 1 1 0N 
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| else j 



else | 



out.writeObject(element); 



if (element instonceof ObjectM) J 

clossName = Object[].class.getName(); 

else { 

className = Object.class.getNameQ; 



code = lookupCode(clossName); 

SerializerIF serializer = lookupSeriolizer(code); 

out.writeByte(code.byteValue()); 
serializer.writeObject(out f element); 



* Writes the tobies to the file. 

*/ 

private void writeTobles() \ 

ObjectOutputStream out = null; 



try | 



File serFile = new File(HASHTABLE_SER); 

out = new ObjectOutputStreom(new FileOutputStreom(serFile)); 



out.writeObjectfgetCodeToble()); 

out.writeObject(getNameToble()); 

out.writeObject(getSeriolizerToble()); 

outwriteObject(new Date()); 
catch(Exception e) | 
finally | 

try | 

out.closeQ; 
\ catch(Exception e) \ \ 
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logic 
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^Transporter^ 



ViewControllers 
(multiple classes) 
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^Destination^ 

EJB Connection ond 
Object creation 
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Example Pattern 
-►Non-intrusive Caching, Tracing or Logging 
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ApplicationMediator 



ViewControllers 
(multiple classes) 
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multiple classes 
ViewEvent to 
RequestEvent logic 
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Snoop Listener: 
issue RequestEvents to log 
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